home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-Sensation: Golden Games / Amiga CD-Sensation - Ausgabe 2 - Golden Games (1996)(GTI - Schatztruhe)(DE)[!].iso / Brain Activity / MineSweeper / MineSweeper.doc < prev    next >
Text File  |  1994-03-09  |  13KB  |  390 lines

  1.  About MineSweeper 2.7
  2.  ---------------------
  3.  
  4. This version of MineSweeper was written in Modula2 by myself,
  5. John Matthews, to be as close as possible to the version that
  6. comes with Microsoft Windows 3.1 (tm), without being based at
  7. all on either the source or object code of that version.
  8.  
  9. This version of MineSweeper, is public domain. Feel free to
  10. give it away, or upload it to your favourite FTP site or BBS,
  11. but please don't modify it. If you want the source, let me know.
  12.  
  13. This program looks best on WB2.0 or higher, on a deinterlaced,
  14. or dblscan workbench, but should work on earlier, lower resolution
  15. displays also. Lower resolutions will limit the size of the custom
  16. option however.
  17.  
  18. MineSweeper is one of those games which are simple in concept,
  19. while surprisingly absorbing and addictive to play.
  20.  
  21. Minesweeper is a challenging game of strategy and luck. Here
  22. follow some instructions on how to play.
  23.  
  24.  Copyright
  25.  ---------
  26.  
  27. This version of MineSweeper is copyright 1992-1993 John Matthews,
  28. and is totally freeware. Distribute it as you like but leave the
  29. documentation intact, and don't modify the program itself. And
  30. please do not sell it for profit, or as part of another product.
  31.  
  32.  
  33.  History
  34.  -------
  35.  
  36. Version 2.0 - June 1992 (I think).
  37.  First Release
  38.  
  39.  
  40. Version 2.1 - April 6 1993.
  41.  Bug Fix :
  42.   Enforcer hits at startup, font colour.
  43.  
  44.  
  45. Version 2.2 - September 10 1993.
  46.  Bug Fixes : 
  47.   Window refreshing after obscure, while high score window up.
  48.   Handles right mouse button better now
  49.    - now works with popup menu programs,
  50.      like Magic Menu (© Martin Korndörfer)
  51.  
  52.  Modified operation a little
  53.    (if you can't figure out how to use it,
  54.     you won't be any good at the game :-) )
  55.  
  56.  Added Custom mode.
  57.  
  58.  
  59. Version 2.3 - September 22 1993
  60.  Bug Fix :
  61.   hashing of display during right mouse button moves on
  62.   non interlaced displays.
  63.  
  64.  Enhancements :
  65.   optimised search routines into assembly language for greater speed
  66.   flashes display at end of game
  67.   changed "Shrink Window" to "Pause", doesn't reset game.
  68.   added keyboard equivalents
  69.   changed from stack search to queue search
  70.     (ripple out after uncovering instead of diagonal paths :-) )
  71.  
  72. Version 2.4 - September 28 1993
  73.  I was in town on Thursday, uploading the new version, and I read my mail.
  74.  So here are the improvements that were requested.
  75.  
  76.  1. Sun-Glasses on successful game :-) (Ingimar Robertsson)
  77.  2. Different methods for Game-Over test
  78.      - All the mines found
  79.      - All the spaces not containing mines uncovered
  80.      - Both of the above
  81.     (Ingimar Robertsson)
  82.     I felt the choice was necessary, as the purpose of a Minesweeper
  83.     should be to Find all the mines, not all the safe locations.
  84.     Really, to make this more interesting, there should be an
  85.     option of a random number of mines, undisclosed.
  86.     Maybe later...
  87.  3. Colour coding of numbers.
  88.     This feature is only available under Version 39 or greater
  89.     of the OS (Kickstart 3)
  90.     (Hannes Gnad)
  91.  4. Previously, the upper left square never contained a mine.
  92.     Now, whatever square you first uncover will have no mine in it.
  93.     (Ingimar Robertsson)
  94.  
  95. Version 2.5 - December 13 1993
  96.  A few modifications made on request, and one minor bug fix.
  97.  
  98.  1. Apparently, faulty mice (ie any that came with an Amiga since
  99.     the Amiga 1000, the best quality machine) make it difficult
  100.     to use the 'mobile cursor', or release over the desired
  101.     square technique.
  102.     At the request of Jonas Peterrson (and wife), this is now switchable.
  103.     The setting is remembered between games ;-)
  104.  2. In the continuing quest to make my version as similar to that
  105.     other version as practical, and desirable, and to make the above
  106.     option safer, at the suggestion (again) of Jonas Peterrson (and wife),
  107.     clicking the other mouse button during an operation, aborts.
  108.  3. The clock no longer restarts after the sequence:
  109.     game over, shrink, unshrink
  110.     (Steven Kuck)
  111.  
  112.  4. Released the source, that is to say the main program file.
  113.     This file is over 3000 lines of messy code. Over the year and
  114.     a half or so that I have worked, off and on, on MineSweeper,
  115.     there is little that hasn't been changed to improve the game
  116.     technique, look and feel, smoothness of display, and speed.
  117.     Not to mention suggestions.
  118.     The code is not pretty, and the purpose of much of it will seem
  119.     obscure. The most obscure parts are those dealing with the
  120.     inadequacies of my compiler to modern Amiga programming, and
  121.     attempts to provide a 2.0+ look and feel even under 1.3.
  122.     Also the optimisations 'occasionally' cause a mess.
  123.  
  124.     I don't include the full source, as what is missing would only be
  125.     useful to someone with M2Sprint Modula-2, and even then most of my
  126.     libraries have been modified.
  127.  
  128. Version 2.6  8 February 1994
  129.  Minor Bug Fix, option change.
  130.  
  131.  1. Releasing RMB, in 'mark guess' mode over uncovered square, caused
  132.     garbage squares down left edge. (Ingimar Robertsson)
  133.  2. Made 'safe' behavior of guessed squares optional. (Ingimar Robertsson)
  134.  3. (Hopefully) Fixed bugs with colours not being freed on EXIT.
  135.  
  136.  
  137. Version 2.7  8 March 1994
  138.  Fixed the bugs introduced in 2.6 :-)
  139.     Mines can now be marked down the left column
  140.     MututalExclude code in Static/Mobile sub menus fixed
  141.     Documentation now up-to-date.
  142.  Coloured numbers now working correctly (3.0 only function)
  143.  
  144.  Bugs
  145.  ----
  146.  
  147. None that I know of. ;-)
  148.  
  149.  Author
  150.  ------
  151.  
  152. John Matthews
  153. tribble@gphs.vuw.ac.nz
  154.  
  155.  
  156.  
  157.   Contents for Minesweeper Instructions
  158.  
  159.  
  160.   I.____Introduction:  What Is Minesweeper? 
  161.  
  162.  II.____How to ... Keep Score
  163.  
  164. III.____How to ... Mark a Square 
  165.  
  166.  IV.____How to ... Play the Game 
  167.  
  168.   V.____How to ... Understand the Rules of the Game 
  169.  
  170.  VI.____Use Strategies and Hints 
  171.  
  172.  
  173.  
  174.  Part I
  175.  ------
  176.  
  177. >> Introduction : What Is Minesweeper?
  178.    -----------------------------------
  179.  
  180. When playing Minesweeper you are presented with a mine field,  and your
  181. objective is to locate all the mines as quickly as  possible.
  182.  
  183. To locate the mines, you uncover the squares on the game board
  184. that do not contain mines, and you mark the squares that do  contain mines.
  185.  
  186. The trick is determining which squares are which.
  187.  
  188. If you uncover all the squares without mines, and mark all those with,
  189. you win; if you  uncover a mine instead of marking it, you lose the game.
  190.  
  191. The  faster you play, the lower your score.
  192.  
  193. You can use the counters at  the top of the window to keep
  194. track of your progress.
  195.  
  196. The counter in the upper-right corner of the window is a timer,
  197. which displays your playing time in seconds. The timer does
  198. not  begin counting until you select a square.
  199.  
  200. The counter in the upper-left corner of the window initially
  201. indicates the number of mines hidden in the mine field. Every time
  202. you mark a square as a mine, this number decreases by one,
  203. even if you incorrectly mark a square. 
  204.  
  205.  
  206.  Part II
  207.  -------
  208.  
  209. >> Keeping Score
  210.    -------------
  211.  
  212. Minesweeper scoring is simple. The counter in the upper-right  corner
  213. of the playing area indicates your playing time. The faster  you find
  214. all the mines, the better your score. 
  215.  
  216. To see a list of your fastest playing times
  217.  
  218.   From the Game menu, choose Best Times. 
  219.  
  220.  
  221.  Part III
  222.  --------
  223.  
  224. >> Marking a Square
  225.    ----------------
  226.  
  227. Knowing when to mark a square as a mine is the key to winning 
  228. the game. 
  229.  
  230. To uncover a square ...
  231.  
  232.   Point to the square, and click the left mouse button. 
  233.  
  234. To mark a square as a mine ...
  235.  
  236.   Point to the square, and click the right mouse button once. 
  237.  
  238. To mark a square as a question mark ...
  239.  
  240.   Point to the square, and click the right mouse button twice. 
  241.  
  242. To change a square marked as a mine into a question mark ...
  243.  
  244.   Point to the square, and click the right mouse button once. 
  245.  
  246. To clear a square marked as a mine ...
  247.  
  248.   Point to the square, and click the right mouse button twice. 
  249.  
  250. Once you have marked at least one square as a mine, you may  be able to
  251. safely uncover more squares by "clearing around"  them. 
  252.  
  253. To uncover all the squares around an uncovered square ...
  254.  
  255.   Click the right mouse button over that square.
  256.  
  257. Instead of just clicking on a square, you can click-drag across the
  258. board until you reach your desired square and then release.
  259.  
  260. In the case of the right mouse button, the effect of drag clicking
  261. depends on the square you clicked on, not the one you released over.
  262.  
  263. For instance, clicking the right mouse button down over a covered
  264. square and (before releasing the button) moving the mouse will
  265. result in attempting to mark the square you release over as a mine.
  266.  
  267. Clicking the right mouse button down over an uncovered square and
  268. dragging will result in attempting to uncover all the squares
  269. around the square.
  270.  
  271. In each of these two cases, releasing over a square of the opposite
  272. type (covered/uncovered) will have no effect.
  273.  
  274.  
  275.  Part IV
  276.  -------
  277.  
  278. >> Playing the Game
  279.  
  280. The object of Minesweeper is to correctly mark all mines as 
  281. quickly as possible without uncovering one. The following 
  282. section explains how to play the game. 
  283.  
  284. To choose a skill level
  285.  
  286.     From the Game menu, choose Beginner, Intermediate, or 
  287. Expert. The higher the skill level, the larger the mine field. 
  288.  
  289. To start a new game
  290.  
  291.     From the Game menu, choose New, or use Right-Amiga-N. Or you
  292. can  click the yellow "happy face" at the top of the game board. 
  293.  
  294. To locate the mines
  295.  
  296. 1.  To uncover a square, select it using the left mouse button. 
  297.     If the square is a mine, you lose. 
  298.  
  299. 2.  If the square isn't a mine, a number may appear. This number 
  300. represents the number of mines in the surrounding eight  squares.
  301.     If there are no mines around the square, it will show blank,
  302. and all the squares around it will automatically be uncovered.
  303. This process is recursive, and can result in large areas of the
  304. board being uncovered.
  305.  
  306. 3.  To mark a square as a mine, select it with the right mouse  button. 
  307.     To mark a square you are uncertain about, point to it and  click
  308. twice with the right mouse button. This marks the  square with a
  309. question mark (?). Later, you can either mark  the square as a mine, or
  310. uncover it. 
  311.  
  312.  
  313.  Part V
  314.  ------
  315.  
  316. >> Understanding the Rules of the Game
  317.    -----------------------------------
  318.  
  319. Follow these rules when playing Minesweeper
  320.  
  321. The playing area is a mine field, simulated by a grid of  squares.
  322. Initially, all the squares are covered. 
  323.  
  324. To uncover a square, point to it and click the left mouse  button. You
  325. continue to uncover squares until only the  squares containing mines
  326. are covered. 
  327.  
  328. If you uncover a square that does not contain a mine, it  either
  329. contains a number or is blank. 
  330.  
  331. If the square contains a number, N, then there are N  mines in the
  332. surrounding eight squares. If the square is  blank, there are no mines
  333. in the surrounding eight squares. 
  334.  
  335. If you uncover a blank square, the surrounding eight  squares are
  336. uncovered automatically because there  cannot be any mines under them. 
  337.  
  338. If you know that a square is a mine, you can mark the  square. 
  339.  
  340. If you uncover a square that contains a mine, the game is  over and all
  341. the mines are displayed. 
  342.  
  343. You can also "clear around" an uncovered number square  whose mine has
  344. already been marked.  For example, two squares labeled 1 may both be
  345. touching a  marked square. If you clear around the uncovered squares, 
  346. you may uncover additional squares that do not contain mines.  If you
  347. clear around a square whose mine is already marked,  the surrounding
  348. numbered squares are uncovered. 
  349.  
  350. To clear around a square ...
  351.  
  352. Point to the numbered square, and then click the right mouse  button. 
  353.  
  354. You are not allowed to clear around a square if you have  not marked
  355. enough mines, or have marked to many mines, in the surrounding eight
  356. squares,  or if the square is covered.
  357.  
  358. For example, if you try to clear around a square labeled 3, and you
  359. have marked only two squares with mines, nothing will happen.
  360. Or, if you try to  clear around an uncovered square, nothing will
  361. happen. 
  362.  
  363. If you clear around a square, and there is an unmarked  mine in the
  364. surrounding eight squares, it is uncovered and  the game is over.
  365.  
  366. If you clear around a square whose mines are incorrectly  marked and a
  367. mine is uncovered, the game is over. 
  368.  
  369.  
  370.  Part VI.
  371.  --------
  372.  
  373. >> Using Strategies and Hints
  374.    --------------------------
  375.  
  376. Helpful hints for playing Minesweeper
  377.  
  378. If an uncovered square is labeled 1, and there is only one  covered
  379. square touching it, that covered square must be a  mine. 
  380.  
  381. If an uncovered square already has the correct number of  adjacent
  382. mines marked, clear around it. 
  383.  
  384. Don't guess unless you have to. If you can't figure out how to move,
  385. try  approaching the area from a different direction or marking
  386. squares with question marks.
  387.  
  388. Guessing may occasionally finish the game more quickly by opening
  389. out the board, but it defeats the purpose of skill.
  390.